主题
打开控制台 - OpenConsole
函数简介
打开控制台窗口。type 为 0 时打开插件进程自身的控制台;为 1 时打开与当前绑定窗口关联的控制台,便于查看日志或调试输出。
接口名称
OpenConsoleDLL调用
c
int32_t OpenConsole(int64_t instance, int32_t type);参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| instance | 长整数型 | OLAPlug 对象的指针,由 CreateCOLAPlugInterFace 接口生成。 |
| type | 整数型 | 打开类型,见下表。 |
type 取值
| 值 | 说明 |
|---|---|
| 0 | 软件本身(插件进程)控制台 |
| 1 | 绑定窗口控制台 |
示例
type=0 打开本进程控制台;配合 LogSetTarget 含 CONSOLE 后写日志,用完 CloseConsole。
SDK 调用
cpp
#include "OLAPlugServer.h"
OLAPlugServer ola;
const int64_t logger = 0; // 默认实例
int ret = ola.OpenConsole(0); // 本进程控制台
if (ret != 1) {
return;
}
ola.LogSetTarget(logger, 2); // CONSOLE
ola.LogInfo("hello console");
ola.CloseConsole(0);csharp
using System;
using OLAPlug;
var ola = new OLAPlugServer();
long logger = 0;
int ret = ola.OpenConsole(0); // 本进程控制台
if (ret != 1) return;
ola.LogSetTarget(logger, 2); // CONSOLE
ola.LogInfo("hello console");
ola.CloseConsole(0);python
from OLAPlugServer import OLAPlugServer
ola = OLAPlugServer()
logger = 0
ret = ola.OpenConsole(0) # 本进程控制台
if ret != 1:
raise RuntimeError("failed")
ola.LogSetTarget(logger, 2) # CONSOLE
ola.LogInfo("hello console")
ola.CloseConsole(0)java
import com.olaplug.OLAPlugServer;
OLAPlugServer ola = new OLAPlugServer();
long logger = 0;
int ret = ola.OpenConsole(0); // 本进程控制台
if (ret != 1) {
return;
}
ola.LogSetTarget(logger, 2); // CONSOLE
ola.LogInfo("hello console");
ola.CloseConsole(0);go
import "github.com/ola/olaplug/olaplug"
ola, _ := olaplug.NewOLAPlugServer("OLAPlug_x64.dll")
defer ola.ReleaseObj()
logger := int64(0)
ret := ola.OpenConsole(0) // 本进程控制台
if ret != 1 {
return
}
ola.LogSetTarget(logger, 2) // CONSOLE
ola.LogInfo("hello console")
ola.CloseConsole(0)rust
use olaplug::OLAPlugServer;
let ola = OLAPlugServer::new("OLAPlug_x64.dll").unwrap();
let logger = 0i64;
let ret = ola.open_console(0); // 本进程控制台
if ret != 1 {
return;
}
ola.log_set_target(logger, 2); // CONSOLE
ola.log_info("hello console");
ola.close_console(0);cpp
var ola = com("OlaPlug.OlaSoft")
var logger = 0
var ret = ola.OpenConsole(0) // 本进程控制台
if(ret == 1) {
ola.LogSetTarget(logger, 2) // CONSOLE
ola.LogInfo("hello console")
ola.CloseConsole(0)
}vbscript
Set ola = CreateObject("OlaPlug.OlaSoft")
logger = 0
ret = ola.OpenConsole(0)
If ret = 1 Then
ola.LogSetTarget logger, 2
ola.LogInfo "hello console"
ola.CloseConsole 0
End Iftext
.局部变量 ola, OLAPlug
.局部变量 ret, 整数型
.局部变量 logger, 长整数型
ola.Create ()
logger = 0
ret = ola.OpenConsole (0) ' 本进程控制台
.如果真 (ret = 1)
ola.LogSetTarget (logger, 2) ' CONSOLE
ola.LogInfo (“hello console”)
ola.CloseConsole (0)
.如果真结束aardio
import OLAPlugServer;
var ola = OLAPlugServer();
var logger = 0;
var ret = ola.OpenConsole(0); // 本进程控制台
if(ret == 1){
ola.LogSetTarget(logger, 2); // CONSOLE
ola.LogInfo("hello console");
ola.CloseConsole(0);
}text
变量 ola <类型 = OLAPlugServer>
ola = 新建 OLAPlugServer
长整数 logger = 0
整数 ret = ola.OpenConsole(0) ' 本进程控制台
如果真 (ret = 1)
{
ola.LogSetTarget(logger, 2) ' CONSOLE
ola.LogInfo("hello console")
ola.CloseConsole(0)
}cpp
#include "OLAPlugServer.h"
OLAPlugServer ola;
int64_t logger = 0;
int32_t ret = ola.OpenConsole(0); // 本进程控制台
if (ret != 1) {
return;
}
ola.LogSetTarget(logger, 2); // CONSOLE
ola.LogInfo("hello console");
ola.CloseConsole(0);原生 DLL 调用
cpp
long instance = CreateCOLAPlugInterFace();
long logger = 0;
int ret = OpenConsole(instance, 0);
if (ret != 1) {
return;
}
LogSetTarget(instance, logger, 2);
LogInfo(instance, "hello console");
CloseConsole(instance, 0);csharp
using System.Runtime.InteropServices;
[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern long CreateCOLAPlugInterFace();
[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern int OpenConsole(long ola, int type);
[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern int LogSetTarget(long ola, long loggerHandle, int targetFlags);
[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern int LogInfo(long ola, string message);
[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern int CloseConsole(long ola, int type);
long instance = CreateCOLAPlugInterFace();
long logger = 0;
int ret = OpenConsole(instance, 0);
if (ret != 1) return;
LogSetTarget(instance, logger, 2);
LogInfo(instance, "hello console");
CloseConsole(instance, 0);python
from ctypes import CDLL, c_int, c_int64
ola = CDLL("OLAPlug_x64.dll")
ola.CreateCOLAPlugInterFace.restype = c_int64
instance = ola.CreateCOLAPlugInterFace()
logger = 0
ret = ola.OpenConsole(instance, 0)
if ret != 1:
raise RuntimeError("OpenConsole failed")
ola.LogSetTarget(instance, logger, 2)
ola.LogInfo(instance, b"hello console")
ola.CloseConsole(instance, 0)返回值
| 返回值 | 说明 |
|---|---|
1 | 成功。 |
0 | 失败。 |
注意事项
| 项目 | 说明 |
|---|---|
| instance | 需先创建 OLA 对象并取得有效的 instance。 |
| 若日志需输出到控制台 | 若日志需输出到控制台,可配合 设置输出目标 - LogSetTarget 将目标包含控制台。 |
| CloseConsole | 使用完毕后建议调用 关闭控制台 - CloseConsole 关闭对应控制台。 |
| 指定窗口远程开控制台 | 不依赖当前 Bind 窗口时,可用 OpenConsoleEx。 |
